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^About This Manual 



USING THIS MANUAL 



This manual, written for the system administrator, de- 
scribes how to install and upgrade the Altos System V^** 
operating system, and how to set up the optional Multidrop 
Conmiunications System and Uninterruptible Power Supply 
(UPS). 

This manual does not describe how to physically connect 
your system or run the application software that you have 
purchased with your system. 



NOTE 

The last section of this manual, "Change 
Information," smnmarizes the changes that have 
been made to the manual since the previous 
version. 



ORGANIZATION 



This manual contains the following chapters: 

Chapter 1, "Installing and Setting Up the Operating 
System," describes how to initially install and set up the 
operating system, reconfigure ports for your terminals and 
printers, and set up user login accounts. 

^ Chapter 2, "Upgrading Your Operating System," explains how 
to upgrade your operating system and install additional 
hard disks. 
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Chapter 3, "Setting Up Your Multidrop System," describes 
how to connect peripherals (terminals, printers, and so on) 
to the communications boards (Multidrop, SIO, or ACPA). 

Chapter 4, "Uninterruptible Power Supply," describes the 
software that supports an Uninterruptible Power Supply, 
and explains how to select the desired power-down process 
for your installation. 



This section describes documentation conventions used in 
this manual. 



MANUAL CONVENTIONS 



Symbol 



Description 



boldface type 



What you t37pe. For example: 



Type tarcv files 



boldface type 



Used for commands, programs, 
utilities, fimctions, and options. 
For example: 



Use the tar command to back 
up your files to floppy disk. 



italic type 



Variables (a value that can change), 
such as files, as shown in the 
example above. Also for manual 



titles, such as Altos System V 
Series 386 Operations Guide, 




Key you press. For example: 



Press 



Press 
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Symbol 



Description 



Ctrl-d 




Keys you press simultaneously 
(separated by a hyphen and shown 
in reverse type). For example: 

■wiiM means you press and 
hold the BSI key and then 
press the d key. 



Kej^ you press sequentially. 

Variables that can change. They 
mean: a (any letter), n (any 
number), x (any letter or number). 
For example: 

Version n.na File name xxxxxx 



ADDITIONAL REFERENCE MATERIALS 



For more information on your operating system, see the 
following list of manuals. To order a manual, call (408) 
434-6688, ext. 3004 and give the manual title and part 
number. 

Owner's Guide (part number 690-21264-nnn or 690-20351- 
nnn) describes how to connect computer components and per- 
ipherals, turn on power, and use the diagnostic programs. 

Using the AOM Menu System (part number 690-1 8055-nnn) 
describes how to use the Altos Office Manager (AOM) to 
install software and manage the operating system. 
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Altos System V Series 386 User's Guide (part number 690- 
21178-nnn) (not shipped with the Run- time system) explains 
basic operating system concepts and programs (e.g., vi, 
ed, sh, csh, mail, sed, and awk). 

Altos System V Series 386 Operations Guide (part number 
690-21 171-nnn) tells how to set up the system for users 
and peripherals, maintain and back up the system, optimize 
system performance, and use uucp communications programs. 
This manual also contains system and LP spooler error mes- 
sages. 

Altos System V Series 386 Reference (C) (part number 690- 
22869-nnn) and Altos System V Series 386 Reference (M) 
(part number 690-22870-nnn) describes the Altos Run-time 
system commands and extended utilities sections (C) and 
(M). 

Altos System V Series 386 Development System Set (part 
number 690-21585-000) contains reference and tutorial 
material. 

Manuals in this set include: 

Altos System V Series 386 C Compiler Library and 

User's Guide 
Altos System V Series 386 C Compiler Language 

Reference 

Altos System V Series 386 Programmer's Guide 
Altos System V Series 386 Macro Assembler User's 

Guide and Reference 
Altos System V Series 386 Reference Sections (CP)f 

(S), and (F) 

DOCUMENTER'S WORKBENCH (part numbers 690-15843-nnn 
and 690-15844-nnn) describes mm, nroff, troff, and type- 
setting functions and conmiands. 
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After you connect the components of your Altos computer 
system and turn on the power, as described in the Owner's 
Guide, you need to install the (grating system programs 
and utilities. 

This chapter describes how to install the Altos System V 
operating ssrstem for the first time. This chapter also 
describes how to set up the S3^tem for terminals and 
printers, create and change user accounts, and set up the 
S5rstem for other users. 



CAUTION 

The installation procedures described in this 
chapter erase all information on the hard 
disk. If you are upgrading your existing op- 
erating system, use the procedures described 
in Chapter 2. 



HOW TO START 



Before you begin: 

1. Read the product Release Notes for recent software 
changes (foimd in the Software Product folder). 

2. Assemble the media you will need for installation: 

• Root File System floppy disk 

• Utilities cartridge tape 

3. Connect the terminal you use for the installation 
procedures (called the "console") to the console port 
(also called port 00 or port 0) of your Altos com- 
puter system (the Owner's Guide for your particular 
system has detailed instructions). 
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4. Optionally, run the system diagnostic tests. Because 
the Altos system is tested before shipping, this step 
is (^tionaL 

However, you can use the diagnostic tests to detect 
problems that could occur as a result of shipment 
(such as loosening of conqx)nents and connections). 
The tests take about one hour. See your Owner's 
Guide for Diagnostics instructions. 

5. Use the copy utility on the Diagnostics floppy disk 
to c<^y the flof^y disk. Be sure to leave the write- 
protect tab on the floppy while you make the copy. 
Alwa3rs turn the power off for 30 seconds after using 
the system Diagnostics. 

Use a soft- tip pen to hand copy the label information. 
Store the original in a safe place. 

6. Make sure your cartridge tape is write-protected 
(point the arrow on the tape to SAFE). 

If you are not familiar with handling floppy disks or 
cartridge tape, see the Owner's Guide for instructions. 



CAUTION 

Do not use the original floppy disk to install 
the operating S3^tenL Always make a copy of 
this and any otiier software you value. 



INSTALLATION SUMMARY 



The following is a summary of installation procedures. 
Detailed procedures are in the next section. 

1. Start up (boot) the system from your copy of the Root 
File System floppy disk. 
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2. Install the utilities from the cartridge tape. 

3. Optionally, set up the system for terminals and 
printer(s). 

4. Create or change user login accounts. 

5. Install AOM and optionzilly install any communication 
software or any application software packages. 
(Refer to the appropriate Altos manual for installa- 
tion instructions.) 

6. Set up the system to display "login" on the other 
terminals so other users can use the system. 



INSTALLING THE OPERATING SYSTEM 



Allow one-hEilf to one hour to install the operating system 
for the first time. If instedlation is interrupted, the next 
time you work with the system a message will indicate the 
S3^tem was not shut down properly. In this event, refer 
to "Recovering from Interrupted Installation" at the end 
of this chapter. 



If you encounter problems or error messages not described 
in this manual (either during or after software installa- 
tion), run the system diagnostic tests. 

During installation, y ou can correct a typing error by press- 
ing the QQIQSQQII key to back up to the error. Then re- 
type the character. 



If your Altos terminal has a screen saver (automatically 
blanks if there is no input from the keyboard or the com- 
puter for 15 minutes), you can restore the display by 
pressing any key. 
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To install the operating sj^tem, 

1. Turn on the power, or with the power on, turn it off, 
wait 30 seconds, then turn it back on. You will see 
the system pass a series of power-up tests. 

Prepare to press any character when you are prompted 
as follows: 



Type any character; to ;; interrupt: autobo^ 



If your S5^tem doesn't pass the power-up tests, make 
sure that your terminal is properly set up and con- 
nected to the computer (it should be connected to the 
console port). 

If you press any character in time, you will see a 
menu (Step 2 shows the first two items of the menu). 

If you don't press a key in time, the system will 
attenq)t to boot from the hard disk, which doesn't 
have the Boot program on it. To correct this, turn 
the RESET/RUN key (on the front of your system) to 
RESET, then to RUN, and press a key when prompted. 

2. If you have not already done so, remove the card- 
board from the floppy disk and tape drive. And, if 
you previously put a write-protect tab on your copy 
of the Root floppy disk, also remove it. When you 
see the following display (or one similar to it), 
insert the floppy disk into the disk drive. 

NOTE 

Make sure your copy of the Root floppy disk 
doesn't have a write-protect tab, so the sys- 
tem can place information on it. 
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\ 

/ Type 2 to boot from the floppy disk. The sequence 

looks similar to the screen that follows. 



DBoot from liard 4is)c 
:()Boot from tlpppY disk 



> 2 

Bootlno iTon Floppy . . . 



X^adlna kernels . , 

Dotmloaaing X/0 Ch«nn«l Coae« « , CDon^I 

^ mmmmmmmmmmmmmmm 

/' 

The screen displays messages that the system is load- 
ing code, the size of memory, and the nmnber of users 
licensed for the system. (This takes several minutes.) 
Then you are asked if you want to check the file sys- 
tem. Type y. 

3. Next, the Welcome to Altos System V menu appears as 
shown in Figure 1-1. 
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WELCOME TO JtLTOS 8Y8TSH V 
V«r«lon n 

Options; 

«. Znctftll Alto* Syctes V for th« flr«t tine 

b< Opgrad* your eoaput«r mr»t»m to Altos S7«te« V 
V«r«ion n fi«l«««« nn 

Ct Restore data to the hard disk from cartridge tape 

d. 3hut dovn the systcib 

e, Bxlt to the shell 

Enter option (a, b, c. d« or e) and press RETURN: 

Figure 1-1. Welcome to Altos System V Menu 

Type a and press |S|S33|||* 
4. The screen displays: 



Installing will overwrite ALL data on the hard disk. 
Do you want to continue? (y/n) 



Because this is the first time you're installing the 
operating system, the hard disk does not have any 
data on it. 

Type y and press Bt/yirill. 
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5. Next, the screen displaj^ the following: 



So you want « «tand«rd Mvwp «r«« iy/n) 
<8wap «r«« «ls« is nxmn Sl^-byt* blocks) 

(Moraallr. you wlll want; to answar "yaa" to this question. ) 



This question refers to S3^tems that use large applica- 
tion programs such as AOM II Plus"" and 20/20™. Most 
of the time you want the standard swap size. 

y and press BilHiiB. 

(If you want to change the swap size, you must sup- 
ply the number of blocks for swap area. The system 
will prompt you througji this procedure. Refer to 
layout(M) in the Altos System V Series 386 Reference 
(M) for information about this command.) 

The system automatically calculates the default num- 
ber of blocks. 

If you have an optional Uninterruptible Power Supply 
(UPS) installed on your system, respond to the fol- 
lowing questions. If you do not have a UPS, skip 
this part. 

Before answering the questions, see CSiapter 4 for 
information about UPS. The screen prompts: 



Do r«u want « VPS f*t*tt^ liartltion? it/n) 



If you have UPS, answer y to this question. Then 
you see the following screen: 



m 
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Enter the taaximum amount of amnoxy^ 

in. me^abyte*^ that ^four syatan will contain? 

(Default - n) 



Press BtfJiliB for the default (which may vary from 
system to system), or enter the maximum amount of 
memory. 

6. Then the following screen is displayed: 



Do you want an extra partition? (y/n) 



You might want an extra disk partition if you are 
planning on loading applications that need a separate 
raw disk partition. Such applications include 
INFORMIX-Turbo or other programs that bypass the 
file system and perform raw disk I/O. 

Type y and press |^3I to create an extra partition. 
If you do not want an extra partition, type n and 
skip the rest of this step and go directly to step 7. 

If you type y, the following prompt appears on your 
screen: 



How many 512-byte blocks do you want in your extra partition? 
(Default * nnnnn; Maximum « nnnnnn) 



Enter your value or press for the default. 

Note that space devoted to an extra partition is 
taken from space normally used by the main file 
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system. Therefore, the larger the extra partition, 
the less space available to the main file S3^tem. 
The extra partition is on /dev/hdOc. 

7. Regardless of whether you add an extra partition, the 
screen next displajrs the following: 



Writln.9 layout information on tli« hard disk. 
Installing a driv« with nnnHB formatted capacity. 
Making tha file «yst«m on tlie hard disk. , . 

Do you want * standard number of files? 

ttha default numtHUir of files is Annnn) 

(Normally^ you will want to answer yes to this question^ 



Most of the time you want the standard number of 
files. 

Type y and press B^BM. 

During this phase of installation, you will see infor- 
mation about the blocks on your system. Then the 
computer checks the hard disk and makes the file 
system. Next, you will see messages that indicate 
this phase is going well. This process takes sev- 
eral minutes. 

If the file system on the hard disk is not correct, 
the system will tell you, and then shut down. You 
should turn your sjrstem off, then back on, and try 
the installation procedure again. If this does not 
correct the problem, refer to your Owner's Guide for 
information on using Diagnostics to isolate the 
problem. 

If the file system is correct, the system creates the 
special files. 
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8. After the following message is displayed: 



** normal Syst«m Shutdowo ** 



the sjrstem automatically reboots, passes a series of 
power-up tests, and displays messages about S5rstem 
configuration. 

Then the following message appears: 



Type any character to interrupt autoboot 



Don't press a key, because you want the system to 
boot from the hard disk. If you do press a key, type 
1 to boot from the hard disk. 



(Some systems may ask you to insert the Utilities 
tape as described in step 9 below before rebooting 
as described in this step. Otherwise, the procedure 
remains the same.) 

9. Next, you are prompted to remove the Root floppy 
disk, store it in a safe place, and insert the Utili- 
ties tape. Check that tiie arrow on the tape points 
to SAFE. 

Insert the cartrid ge tape that contains the Utilities 
and press IrftiJiB. 

As utilities are copied from the tape to the hard 
disk, you will see messages listing the file name and 
number of bj^es and tape blocks. These messages 
have the form: ^ 

k 

X filename, numbeT-of-bytes, numbeT-of-blocks 

You will also see messages saying that a file has 
been linked to another file. These messages are for 



1-12 



Installing and Setting Up the Operating System 



background information only; they require no action 
from you. 



CAUTION 

Do not remove the cartridge tape until a mes- 
sage on the screen teUs you to remove it, and 
the indicator lig^t on the tape drive is off. 



After the last file has been copied to hard disk from 
the tape, the di^lay of file names stops. 

When this process has cosopleted, the qperating system 
is installed on the hard disk. 

10. Remove the Utilities tape and store it in a safe 
place. Installation continues as system files are 
config^ed. The next pron9)t refers to instzdlation 
of an additional hard disk. 



INSTALLING ADDITIONAL HARD DISKS 



The S3^tem begins this phase of instsiUation by asking: 



Do yoU waAt to install a Aecondl hard dlvk on joar aysten? 

liliillliillll^^^ 



If you do not have a second hard disk, type n and press 
BtMiW. and then skip this step. 



1-13 




Installing and Setting Up the Operating System 



CAUTION 

This procedure erases all data on the addi- 
tional hard disk. 



If you have a second hard disk» type y and. press BtfJJiB . 
The system then asks you about swap area and number of 
files. Step 5 (in the previous section) describes how to 
respond to these questions. 

As the file system on the second hard disk is set up, you 
3vill see messages about what is happening. When this part 
of the installation is finished, a message tells you that 
the additional hard disk is correctly installed. 

If you have a third hard disk, the syTStem will repeat the 

installation procedures for it. Install the third hard 

disk as you did the second. ( 

If the file system installation does not occur as de- 
scribed, see "Recovering from Interrupted Installation" 
later in this chapter. 



SETTING UP THE PORTS FOR TERMINALS 
AND PRINTERS 



This stage of installation deals with configuring ports 
for peripheral devices (terminals, printers, and so forth). 
The screen displays the following message: 



Do you want to change the descriptions of the texininal(s) 
and/or printer(8)? (y/n) 
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The system is already set up so you can connect Altos ter- 
minals and standard printers to the ports on your system. 



NOTE 

Ports used for optional communications prod- 
ucts, such as port 04 for WorkNet II"; are not 
available for use with terminals, printers, or 
modems. 



Table 1-1 shows an exan9>le of the factory (default) set- 
tings for a 10-user system. 



Table 1-1. Port Configuration 



Port 


Device 


Terminal 


Printer 


Baud 


Action 


Modem? 


Naae 


Type 


Type 


Heme No.* 


Rate 


(On/Off) 




console 


tervinal 


altoaS 




9600 


On 


No 


parallel 


printer 








Off 


No 


ttyOl 


printer 




local default 


9600 


Off 


No 


tty02 


terminal 


altoaS 


2 


9600 


On 


No 


tty03 


terminal 


altosS 


2 


9600 


On 


No 


tty04 


terminal 


altosS 


2 


9600 


On 


No 


tty05 


terminal 


altosS 


2 


9600 


On 


No 


tty06 


terminal 


altosS 


2 


9600 


On 


No 


tty07 


terminal 


altosS 


2 


9600 


On 


No 


ttyoe 


terminal 


altosS 


2 


9600 


On 


No 


tty09 


terminal 


altosS 


2 


9600 


On 


No 



or Runstate 



When 5rou first install the operating S5^tem, you may need 
^ to change the settings of a port to tell the system what 

kind of terminals and printer(s) are connected. To do 
this, you will use the Port Configuration (pconfig) pro- 
gram. The following pages explain these procedures. 
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If yo u do no t need to change port settings, type n and 
press B!>SW. and continue with the following section titled 
"Creating and Changing User Accounts." 

If you need to change a port's setting, type y and press 



The next message refers to the type of terminal you are 
using: 



Tour tetmimX typm 'xaopf"^ Xt comet preas iiSTir, 
If aoty enter tlu^ <»rr«et t«xmina]. typie «nd press HEIK: 



where xxxxx is the name (code) of the terminal you are 
using. Type BtfJUiB if your terminal type is displayed. If 
you aren't sure w hat code to use for your terminal, type 7 
and press ligMliiii to display the valid terminal types. 

The Port Configuration screen appears. An example screen 
follows in Figure 1-2. 
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PORT coNPiouiuirioK UTXtxrr 



Feb 23 15:20:17 19B7 



Pre** 'V tor Help 



Port 


Omvtem 


Terminal Printer 


Printer 


Baud 


Action 


Mod 


Kam* 


Type 


Type Heme 


Mo.* 


Hat* 


{On/Of f1 




eonsoltt 


terminal 


altosS 




9600 


On 


Mo 


parallel 


printer 








Off 


No 


ttyOl 


printer 


local 


default 


9600 


Off 


No 


ttr02 


terminal 


altoaS 




9600 


On 


No 


ttyoa 


terminal 


altos5 




9600 


On 


No 


tty04 


terminal 


altosS 




9600 


On 


No 


tty05 


terminal 


altosS 




9600 


On 


NO 


tty06 


terminal 


altos5 




9600 


On 


No 


tty07 


: terminal : 


altoaS 




9600 


On 


No 


ttyOS 


:: terminal 


altosS 




9600 


On 


No 


tty09 


terminal 


alt0S5 




9600 


On 


No 


To add a 


new port 


to the llat. 










HAZN>HENU: Add 


Change Delete 


Hemote»-printer : 


Quit 





or Runatate 



Figure 1-2. Port Configuration Screen 



Use this screen to add a new port to the list, change a 
port's settings, or remove a port from use. Yciu can set 
up a port for use with a terminal, printer, or modem. 



The top line of th e screen displays the current date and 
tells you to press ltl4JRlll to get Help. The center part 
of the screen lists the following for the ports on your 
system: 



Port name (e.g., console, parallel, ttjK)l) 
Type of device (terminal or printer) 
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• Type of terminal 

• Printer name (or run state) 

• Printer number (or run state) 

• Baud rate 

• Action (on or off) 

• Modem connection 

The bottom of the screen contains a Message line and Cilom- 
mand line. The Ctommeind line currently contains the Main 
menu. From this menu, you can add, change, or delete a 
port, set up a remote printer, or quit the program. (Other 
menus also appear on the Command line.) 

Note that the cursor is on the Add option, and the Message 
line explains, "To add a new port to the list." The Mes- 
sage line displays a description of a command. When ne- 
cessary, this line also displays an error or warning mes- 
sage. 

As you use the Port Configuration program, you will be 
selecting commands or items from two types of menus: 

• Ck)nmiand line menu 

• Center screen menu 

The following tables explain how to select a command or 
item from each of these menus. 
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Table 1-2. Command Line Menu 



Action 



Key to Press 



Move to another command 
Right (move forward) 
Left (move backward) 
Select highlighted command 
(current setting or default) 



First letter of a command 

m 




Table 1-3. Center Screen Menu 



Action 



Key(s) to Press 



Select highlighted option 

(current setting or default) 
Move down in a column 

Move up in a colunm 
Move right in a row 
Move left in a row 
Go to next screen 
Go to previous screen 




There are Help screens to guide you through this program. 
If you ne ed an e3q>lanation of a particular option, press 
which will di^lay help for the current screen. 



Ctrl-w 
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Adding a Port 

To add (enable) a new port: 

1. Select Add from the Command line. The screen dis- 
pla3rs a list of valid port names. 

2. Type the name of the new port (tty16, for example). 
The defau lt settin gs for that port are displayed. You 
can press Mg/JiW to select the default settings or se- 
lect a new setting. The Message line displas^ the 
following: 



A video display unit with a ser««n. and keyboard. 
D£VlC£>Typei TerninAl Prlntar Moden Other 



3. Valid device types are Terminal, Printer, Modem, or 
Other. S elect th e type of device you want to add, 
and press |3gQS|. 

4. For terminals, the screen displays a list of all 
valid terminals. Sel ect the terminal type (or type 
its name), and press 

For printers, see the following section, "Setting Up 
a Printer." 

5. Next, you are asked if you want to set up a mod em 
on the port. Select Yes or No and press 

The difference between selecting "Terminal" with a 
modem and "Modem" is that serial lines for "Modem" 
are configured for both dialing in and dialing out. 

6. The screen displays the available baud r ates 
(speeds). Select a baud rate and press 



1-20 



iaiL 

Installing and Setting Up the Operating System 



7. Then you are asked to select an action: Active (on) 
or Inactiv e (off). Select the action for that port 
and press 

8. A message then asks if you want an auxiliary printer 
on the port. Select Yes or No. 

If you select No, the final settings for the port 
appear on the screen. If you select Yes, a list of 
printers appears on the screen. 



NOTE 

If you print from an auxiliary printer, during 
printing, the S3^tem will redirect data to the 
printer using the terminal's transparent print 
mode. All echoed output to the terminal will 
be disabled; however, to stop printin g and 
regain control of the terminal, press IQQ* 



9. Select a printer from the list and press BBIHIL You 
are then prompted to type a printer name and printer 
number. (Valid numbers are 0 to 255, and valid names 
are up to 14 alphanumeric characters.) 

10. Next, you are asked to supply the mode flags for the 
auxiliary printer. These flags set the protocol for 
the printer (for example, odd or even parit y). Yo ur 
printer manual e^^lains these flags. Press BIBBB for 
the default, or enter the flags for your particular 
printer. 

11. The Port Configuration screen reappears, displasdng 
the ports (including the changes you've just made). 

The final settings are displayed for that port. If 
you are finished changing the settings an d want to 
resume installaticm, select Quit and press BSStWL 
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12. You are asked for confirmation that the port assign- 
ments are correct . If they are correct, select Yes 
and press BQ]Q. The system updates the port con- 
figuration information. 

If the changes are not correct, select No. You are 
asked if you want to continue in peonfig. If you 
want to make other changes or corrections, select 
Yes. 



Changing a Port 

To change the settings for a port: 

1. Select Change from the Main menu Command line. 

2. Select the port you wish to change by moving the 
cursor to that port (or typing its name) 2ind pressing 
MfMiiB. You are then asked questions about the de- 
vice attached to that port. 

3. The screen displays the type of device connected to 
that port; valid types are Terminal, Printer, Modem, 
or Other. 

The defau lt settin gs for the port are displayed. You 
can press BtfJiJ to select the default settings, or 
enter information a bout the port. Select a new type 
of device, or press to leave this setting un- 

changed. 

If you select Printer, see the following section, 
"Setting Up a Printer." 

4. For terminals, the screen displays a list of the valid 
terminals. The cursor is on the current terminal 
type (if the device on this port was previously a ter- 
minal). 

Selec t the te rminal ty pe (or t ype its name) and 
press 1^3, or press 13^11 leave this setting 
unchanged. 



1-22 



Installing and Setting Up the Operating System 



5. Next, you are asked if you want to set a mode m 
on th at port. Select Yes or No and press or 
press BtfJIW to leave this setting unchanged. 

The next questions ask for the following information: 

• Baud rate (speed) of the modem. 

• Action for the modenu Active or Inactive. 

• Auxiliary printer for the port and mode flags for the 
printer. 

To answer these questions, you can either select fr om a 
list (move the cursor to the item you want), press |£Si3 
to leave the setting unchanged, or type the required in- 
formation. Steps 6 - 12 in the previous section, "Adding 
a Port," describe refuses to these questions. 



Setting Up a Printer 

Your system is already set up for a serial and parallel 
printer (see Figure 1-2). Using the Port Configuration 
program, you can do the following: 

• Change the existing serial printer 

• Add another serial printer 

• Cliange the printer device assigned to the parallel 
port 

• Set up a remote printer 



1-23 



Installing and Setting Up the Operating System 



Serial Printer 

To add or change a serial printer port: 

1. Select Add or Change from the Main menu Command 
line. 

2. Select the port you want to change. 

3. Select Printer when you are prompted for a device 
type. A list of valid printer types appears on the 
screen. 

4. Select a printer type from the list, or if you are 
adding a prin ter, enter the type (e.g., laser) and 
press You are then asked to supply a name 
for the printer. 

5. Type a name for the printer and press BtVaHlM. Valid 
names can be up to 14 alphanumeric characters. The 
next prompt asks for a printer number. 

6. Type a number for the printer and press ISSSI* 
Valid numbers are 0 through 255. The firet (default) 
printer is printer 0, the second printer is 1, and so 
on. 

7. Then the screen displa37S valid baud rates (speeds) 
for the printer; the cursor highlightis the cu rrent 
baud ra te. Select a rate and press HtfJUiB. or press 

to leave this setting unchanged. 

8. Next, a message asks you to enter the printer mode 
flags, and displays the default values for these 
flags. These flags set the protocol for the printer 
(e.g., odd or even parity). Your printer manual ex- 
plains these flags. For example, 

cs8 -parity opost -nl -tabs 

Press ISSSS to select the displayed flags, or enter 
new flags as you are prompted. 
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Then the main Port Configuration screen reappears. 



Parallel Printer 

To change the printer device assigned to the parallel 
printer port: 

1. Select Change from the Main menu Command line. 

2. Select the parallel printer port. A list of valid 
printer types appears on the screen. 



NOTE 

Use a Centronics interface on the parallel 
port. 



3. Select a printer type from the list, or if you are 
adding a printer, enter the type and press Btf^liW . 
You are then asked to supply a name for the 
printer. 

4. Type a name for the printer and press It/JiiM. Valid 
names can be up to 14 alphanumeric characters. The 
next prompt asks for a printer number. 

5. Type a number for the printer and press lii^JJiB. 
Valid numbers are 0 through 255. The first (default) 
printer is printer 0, the second printer is 1, and so 
on. 

6. Next, a message asks you to enter the printer mode 
flags, and displays the default values for these 
flags. These flags set the protocol for the printer 
(e.g., odd or even parity). Your printer manual 
should explain these flags. For example, 

cs8 -parity opost -nl -tabs 
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Press BSQI to select the di£fplayed flags, or enter 
new flags as you are prompted. 

The Port Configuration screen reappears and displays 
the settings for the ports. 



Remote Printer 

A remote printer is one that is attached to a port on a 
remote machine networked to your system. To set up a 
remote printer: 

1. Select Remote-printer from the Command line. You 
will see a list of valid remote-printer names. You 
are prompted for a printer name. 

2. Select a nam e for the printer (or type a name and 
press ISSSi)* Then you are asked to enter a number 
for the printer. 

3. Type a number for the printer and press 

Valid numbers are 0 through 255. The first (default) 
printer is printer 0, the second printer is 1, and so 
on. Th^ you are asked for a printer type. 

4. Select or enter the printer type (e.g., laser) and press 

The next prompt asks for the name of the 
remote machine to which the printer is connected. 

5. Type th e name of the remote machine and press 
fBBB- Then the screen displays valid baud rates 
(^eds) for the printer; the cursor hi^ilig^ts the 
current baud rate. 

6. Select a baud rate and press B^jQI, or press ISSBS 
to leave this setting unchanged. 

Next, a message asks you to enter the printer mode 
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flags, and displays the default values for these flags. 
These flags set the protocol for the printer (e.g., odd 
or even parity). Your printer manual should explain 
these flags. For example, 

cs8 -parity opost -nl -tabs 

7. Press I^QQI select the displayed flags, or enter 
new flags as you are pronq)ted. 

The Port Configuration screen reappears and displaj^ 
the settings for the ports. 



Testing a Printer 

After you set up a port for a printer, it's a good idea to 
test it using the Ip program. Do this after you finish 
the installation procedure. For example (with ip as the 

^, default), type: 

10/ 

ip filename ISSuD 

where filename is the name of a file (e.g., /etc/passwd). 
If the printer does not print correctly, refer to your 
printer manual and chedc one or more of the following: 

• The printer is connected to the correct port and is 
switched to "ON." 

• You have the correct type of printer cable. 

• The following settings for the printer are correct: 

■ baud rate 

■ parity setting 

^' m linefeed or carriage return settings 
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m XON/XOFF protocol 
■ word leng^ setting 

Removing a Port from Use 

To remove a port from use: 

1. Select Delete from the Main menu Command line. 
New conmiands appear on the Conmiand line. 

2. Select Remove from the Command line. A message 
asks if you're sure you want to delete the port from 
use. 

3. To confirm the deletion, select Yes. If you don't 
want to remove the port, select No. At this point, 
you can remove another port from use. 

4. To return to the Port Configuration Main menu, select 
Quit. 

Exiting the Port Configuration Program 

When you are finished making changes to the ports: 

1. Select Quit from the Command line. A message asks: 



2. To save the changes you have made, select Yes. The 
ports are reccmfigured, and installation resumes (see 
the next section). 

If you decide you do not want to save the changes, 
select No. You are asked if you want to continue in 
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pconfjjg. If you select Yes, the pconfig screen re- 
appears. If you select No, installation continues. 

After you set up the ports for terminals, printers, and 
so forth, installation continues. If you need to change 
the port settings in the future, either Using the AOM 
Menu System or the Altos System V Series 386 Opera- 
tions Guide will es^lain how. 



CREATING AND CHANGING USER ACCOUNTS 



This part of the installation deals with setting up users. 
The screen displays the following message: 



"^j you want to Add tt«ir« UB«rk and/or 4£hMg« «xiatlnji 



You should create a login (account) name fo r each person 
using the system. Type y and press Bg/:>iliM . 

The screen displays the following: 



Your terminal 'tfP* ^* xxxzx - Correct? lY/n) 



where xxxxx is the type of the terminal you are using. 

Type y if your terminal type is displayed. 

Type n if the terminal type displayed is not correct. The 
system then asks you to enter the terminal type. 

Enter the correct terminal type (for example, altosS for 
the Altos V terminal). You are asked to confirm the ter- 
minal type. 
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Then the User Administration screen appears (see Figure ^ 
1-3). 



0«cr Adnlnlfftrstton 



Cowi«n«l«t mhontf Add« «l«].*t«> cfa«ng«* us«r, U««r«f group, 
OroupKf It quit 



Figure 1-3. User Administration Screen 

User Administration Commands ^ 

Command words appear at the top of the User Administra- 
tion screen. To set up a user account, use a combination 
of two command words, typing the first letter of each word. 
A description of each conmiand follows. 



Command Description 



add user usemame Adds a new user to the system 

add group groupname Adds a new group to the system 

delete user usemame Deletes a user from the system 

delete group groupname Deletes a group from the system 



show user usemame Displays a user's attributes 

show group groupname Displays a group's attributes 

change user usemame Changes a user's attributes 

change group groupname Changes a group's attributes 
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Command 



Description (Cont.) 



Show Users 
show Groups 



Shows all current users 
Shows all current groups 



! shell command 



Returns to the shell; execute 
conmiands 



help 



Displays the help screen 



quit 



Returns to AOM or the shell 



Creating a User Account 

Guidelines for creating/changing a user account follow in 
the next section. To create a user account: 

1. Type a ("add" appears at the bottom of the screen). 

2. Type u ("user" appears next to "add"). 

3. Type a user name, and press |^33. 

You can only enter one user or group at a time; add Users 
and add Groups are not legal commands. 



The program automatically assigns user ID, group ID, full 
name, directory, and shell. Initially there is no password. 
The new user can set up a password. If your system is on 



NOTE 
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a WorkNet® network, make sure the user ID and account 
name are the same on all machines in the network. 

For example, to add a user named beth, enter the following: 

a u beth 

The system responds with 



The screen then displays the system settings for beth (see 
Figure 1-4); to change a setting, type the single letter 
that is to the left of each Ihie. 



Coatt«Ad«i 4thtiw« Add. dAl«ttt, «h*n9«, u<«r. tit^rm, group. 



b. tim^t tUs 29 

a. tttti»V JdJ J, 

i. txmi tlhmit hnt,h 

<t. i^Mtt — T«tMro t« top 



Which riflld? 



Figure 1-4. Example of Creating a New User Account 
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After you finish setting up the account, type q to cause 
the changes to take effect. The screen displays the fol- 
lowing: 



Xnstmi3.ng front /itt<:/ntimiMer 

Canmand: 



You can now enter another User Administration command, 
or type q to resume insteillation. 



Guidelines 

When you create or change a login user accotmt, use the 
j following guidelines: 

1. Make the user name short (the user will enter it 
often). Use lower-case characters: up to 8 letters 
or numbers (no spaces). The user should enter the 
name exactly as created. 

2. Do not use a name with any upper-case letters unless 
that person actually has a terminal that has only 
upper-case letters. If a name is created with only 
upper-case letters, use of the system is han^red. 

3. Do not set a password for the user. If one is set, 
no one will be able to log in to that account. How- 
ever, to remove a password that someone has for- 
gotten, change the pass word to <NOT SET> by 
entering e and pressing tBML 
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4. Choose the shell the user will log in to. The shells ( 
are: 

• /bin/aomlogin—Altos Office Manager (with 
menus) 

• /bin/sh— Bourne Shell 

• /bin/csh— C Shell 

After you set up user accounts, installation continues. If 
you need to add or change users in the future, either 
Using the AOM Menu System or the Altos System V Series 
386 Operations Guide will explain how. 



CHECKING THE FILE SYSTEM, SETTING THE DATE, 
AND STARTING UP 



The next installation step is to check the file system. 
Your sequence will look similar to the following screen. 



checking th« £il« «y«t«iB on -the hard clisk... . . 
/d«v/hdOb 

Fll« S;^Bt«iB2 VolunaiKdOb 

** Phase 1 - Check Blocks «nd Sizes 

** Phase 2 - Check Pathnaaes 

Phase 3 - Check Gpnnecti'^lty 
*'* Phase 4 - Check Reference Counts 

Phase 5 - Check Pree List 
nnn files nnnn blocks nnnnnn free 

The file system on the hard disk is correct 
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If the operating system is not correctly installed, the 
system will tell you. You should turn your system off, 
then back on, and try the installation procedure again. 
If this does not correct the problem, refer to your Owner's 
Guide for information on using system diagnostics to iso- 
late the probleuL 

After the file system check, the screen displays the date 
and asks for confirmation, then it displa}^ the time and 
asks for c onfirma tion. If the date and time are correct, 
just press l^gQQjj. The sequence looks similar to the screen 
that follows. 



Current syat«a ti«i« 1« mx M«y 1 1€I:38:10 PST 1987 
£At«r d«it« iytitmdd) or pr««« METURir ti okt 



ent«r titkM {hhw) or pr«sA SETUltN if okt 



To change the date and time, use the following format: 

yy = last two digits of the current year 

nmi » current month 

dd = current day of month 

hh = hour (24-hour clock) 

mm = minutes 

For exan4>le, enter May 1, 1987 as: 

870501 and press ICTTW 
Enter 4:30 pm as: 

1630 and press BtfJ4W 
The screen displaj^ the date and time as you set them. 
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A message tells you that the system is correctly installed. 
Then the system proceeds with normal startup and the 
"login" pron^)t appears on terminals so other users can 
now log in. 



RECOVERING FROM INTERRUPTED INSTALLATION 



If installation is interrupted, you may receive the follow- 
ing message after you restart the system. 



thtt <iyttt«a wa« not «hut 4owti properlj". 

Th« root fll« <]r>t«n trill b« «l«An«<}> 

(T7t>« "xio" onlt it you utoit tn Avoid cl««tniAir- 7 

^, 

Always allow the root file system to be cleaned. This 
process begins automatically after a few seconds. It 
validates the consistency of the disk file system, which 
may have been damaged, and automatically repairs it. If 
there is no damage, you will see a screen similar to the 
following: 



/tieir/root 

Phase I - Check Blocka an4 Sizes 

** t>has« 2 Check PAthnamea 

** Phaae 3 - Check Connectivity 

Phase 4 - Check Keferance Counts 

Phase S - Check Free List ■ 
nnn files nnnn sectors use4 nnnnnn sectors free 

iiiiiiiiiillii^^^^^^ ,^ 

If the file system was damaged, it is automatically re- 
paired and you will see the corrections that have been 
made. 
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After the Normal Sjrstem Shutdown **" message ap- 
pears, the system may ask you to insert the Utilities tape 
and press BtMBB. 

If nothing appears on the screen after the message 
"Booting from Hard Disk," the installation procedure has 
failed. Start installation again, select 2, Booting from 
the floppy disk, and follow the instructions at the begin- 
ning of this chapter. 

If you conq>leted the installation of the main hard disk, 
but were unable to install the second hard disk, try in- 
stalling it using the add.hd procedure described in Chap- 
ter 2. 

If, after repeating the installation process, you still 
can't install the operating system, refer to your Owner's 
Guide for information on using Diagnostics to isolate the 
problem. 



WHERE TO NEXT? 



After successful system (and optional software) installa- 
tion, the next step is for you and other users to begin 
using the system. In addition, you will probably want to 
read the documentation that comes with your system; look 
at the section titled "Related Manuals" in the front of 
this manual. 

As you become familiar with the sj^tem, you will discover 
that there are many tasks it can do for you. The follow- 
ing paragraphs describe where to turn for information if 
you want to: 

• Use the S5rstem— refer to the User's Guide for your 
system for basic concepts such as logging in and out, 
typing commands, and using files and directories. 
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Manage the S5^tem~tum to either Using the AOM Menu 
System or the Altos System V Series 386 Operations 
Guide for tasks such as becoming the system admini- 
strator, adding new users, changing the ports, back- 
ing up the file system, shutting down the system, and 
so forth. 

Install other software—refer to Using the AOM Menu 
System and the product software Release Notes and 
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This chapter describes how to upgrade your operating sys- 
tem. If you are installing the operating S37Stem for the 
first time, use the procedure described in Chapter 1, This 
chapter also describes how to install an additional hard 
disk. 



INTRODUCTION 



Before you begin the upgrade procedure, assemble the media 
(floppy disk and cartricjfee tape) you are going to use for 
the upgrade. Always make a copy of the media you are 
going to use, and label each by hand. You must have 9000 
free blocks on the root file S5^tem; type df to see the 
amoimt of free blocks you have. 

During the upgrade, the operating system: 

• Preserves sj^tem files that you have probably changed 
(e.g., /etc/passwd, which changes when you run the 
User Administration program) 

• Preserves user files 

• Replaces other system files with new files of the 
same name 



NOTE 

Communication products and any applications 
will have to be re-installed after the upgrade. 



You must be logged in as the sjTStem administrator (either 
admin or root) and be in single-user mode to upgrade 
the S3^tem. 
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INSTALLING THE UPDATED VERSION 



Before you begin the actual upgrade procedure, read the 
product Release Notes (found in the Software Product 
folder) for specific upgrade steps. 



CAUTION 

Do not use the original floppy disk to upgrade 
the operating system. Always make a copy this 
and any other software you value. 



Some upgrade procedures may ask you to back up your hard 
disks; messages on the screen will prompt you through this 
process. 

Use the tar command to back up all of your data on the 
hard disk(s) (for example, the /usr files and special 
files). Then assemble the media you are going to use for 
the upgrade, and proceed as follows. 

1. Log in as root and enter root's password. 

2. Optionally back up all your /usr and special files. 

3. Shut down the system. To do so, type: 

/etc/shutdown -gn and press IHSBB 

where n is the number of seconds until shutdown 
occurs (0 to 999). It's a good idea to give other 
users on the system time to finish up and log off 
(5 minutes or so). The default is 60 seconds. 

4. As shutdown precedes, you will see messages that 
the system is shutting down and services are stop- 
ping. Then you will see the following: 
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** formal :Syst«m Shutdown ** 



5. Turn the RESET/RUN key to RESET, then back to 
RUN. You will see the system pass a series of 
powerup tests. Prepare to press any character when 
prompted. 



Type any character Interrupt boot 



If you press a character in time, you will see a menu 
(Step 6 shows the first two items of the menu). If 
you didn't press a key in time, turn the RESET/RUN 
key to RESET, then back to RUN, and press a key 
when prompted. 



NOTE 

Make sure your copy of the floppy disk does 
not have a write-protect tab, so the system 
can place information on it. 



6. When you see the menu below, or one similar to it, 
insert your copy of the Root floppy disk into the 
disk drive. Enter 2 to boot from the floppy disk. 



Snter [1] to boot trom Rar4 Disk 

t2] to boot from Floppy Disk 



Enter option: 2 
Booting from Floppy- 



2-5 



upgrading Your Operating System 



The screen di^lays messages that the system is load- 
ing codet the version number of the operating ^tem» 
and the size of available memory. 

7. Then you will see the following menu. 



VELCOKS TO SYSTEM V 

Version n 



Options; 

<k» install AXtos Syst^st V tor tbft tirst tl** 

h, Xipgrsdfr yoar cempatitt My»tm to Altos SysteM V 
Version a Release an 

Bestore data to the hvtd ^sk from cartridge tap« 
4« Shut down tbe systaift 
Exit to tbe «h«Il 
Eater option (a. 1>« e. tL. or e) and pr«s# KBIvnt: 



Type b and press HtfdlM A message on the screen 
may prompt you to back up your files if you have not 
already done so. 

8. You will see messages as the upgrade continues. 
First the file system is checked. Then the upgrade 
procedure saves the local sj^tem files. Finally, the 
system shuts down and reboots. 

9. Next, you are prompted to remove the floppy disk, 
store it in a safe place, and insert the Utilities 
tape. Before doing so, make sure the arrow on the 
tape points to SAFE. 
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(If the S5rstem doesn't automatically reboot after 
shutdown, refer to "Recovering from Interrupted 
Installation" in the previous chapter.) 

Insert the cartridge tape that contains the Utilities 
and press B^QJj. The system copies the utilities from 
the cartridge tape to the hard disk. You will see 
messages of the form: 



You will also see messages sa3dng that a file has 
been linked to another fUe. These messages are for 
information only. After the last file is copied to the 
hard disk, a message asks you to remove the Utilites 
tape. 

10. Remove the Utilities tape and store it in a safe 
place. Next, the other system files are configured 
and then the local file system is restored. 

After this part of the procedure is complete, messages on 
the screen ask if you want to do some tasks: 

• Install additional hard disks (see the next section). 

• Change the descriptions of the terminal(s) and/or the 
printer (see the previous chapter). 

• Add or change user accounts (see the previous 
chapter). 

Lastly, the file sj^tem on the hard disk is checked. You 
are a^ed if the time and date are correct (the previous 
chapter explains how to set these). Then the system 
rest£irts and goes to multi-user mode, so other users can 
log in. 
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INSTALLING ADDITIONAL HARD DISKS 



This section explains how to set up the software for an 
additional hard disk. You must be the sj^tem adminis- 
trator (logged in as root or admin) for this procedure. 



CAUTION 

The add.hd command erases any files on the 
additional hard disk. 



For example, to add a second h£U'd disk, type: 

add.hd 2 and press 

The add.hd conmiand initializes the second hard disk, 
creates the bad sector table, and creates the file sj^tem. 
At times you will be prompted for information to enter 
(e.g., if 3^u want to change the size of the swap sirea). 
If you need to change the swap area size or nuinber of 
files on the second hard disk, see "Installing the Operat- 
ing SjTstem" in CSiapter 1. Then the system runs the fsck 
program, makes the /usr2 directory, and mounts the hard 
disk. The add.hd command adds a line to the startup file, 
so that every time the ^stem is brought up for multiple 
users (displays "login:" on other terminals), the second 
hard disk will be mounted. 
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INTRODUCTION 



This chapter briefly describes some of the communications 
capabilities of the optional Multidrop system, which al- 
lows you to connect additional devices (terminals, print- 
ers, and the like) to your systenu With Multidrop, you 
can connect both RS-232 and RS-422 devices. 

For a more complete explanation of the Multidrop S3^tem, 
see the Multidrop installation manual (or the Owner's 
Guide for your system). 



CALCULATING PORT ADDRESSES 



The numbers (addresses) that are assigned to the ports on 
your system depend on how the communication (COMM) 
boards are installed. (Note that in the pages that follow, 
the port nimiber, tty number, and TCU address are synony- 
mous.) 

Currently, Altos offers three types of communications 
boards: a Serial Input/Output (SIO) board, a Multidrop 
Conmiunications (MDC) board, and the Advanced Communica- 
tions Processor Attachment (ACPA) board. In general, 
these boards can be mixed in a system, but no more than 
two MDCs are supported per sjrstem. 

There are additional limitations that are specific to cer- 
tain machines. For example, the Altos 386 Series 1000 
does not support any MDC boards, and makes its Multidrop 
connections through the Multidrop connector found on the 
ACPA/1000 board. Your Release Notes describe the specific 
limitations that apply to your system. 

The MDC reserves 64 ports for devices: The first 5 ports 
(00 - 04) are RS-232 ports and the remaining 59 ports 
(05 - 63) are RS-422 ports. The first three of these re- 
maining 59 ports are reserved for RS-422 use, but if you 
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want to connect RS-232 devices to the last 56 ports (08 
-63), you can do so by using a Terminal Cluster Unit 
(TCXr). You connect RS-422 devices to ports 05, 06, and 
07 on the MDC via a junction box and drop cable. 

The addresses on the Terminal Cluster Unit-8 (TCU-8) 
should be in multiples of eight. For example as shown in 
Figure 3-1, the first TCU-8 occupies ports 08 - 15, the 
second TCU-8, ports 16 - 23. Recall that a TCU-8 can 
never occupy ports 00 through 07. 

Ports on an SIO board are addressed in groups of eight or 
ten, depending on which type of SIO your S5^tem uses. 
(For example, a 386 Series 1000 uses an eight-port SIO, 
while the Series 2000 uses a ten-port SIO.) Regardless of 
how many are available, all SIO ports are RS-232 ports. 

ACPA boards, however, address ports just like an MDC: 64 
maxlumimi ports, with the first 5 as RS-422 ports and the 
remainder as RS-232. An ACPA for a 386 Series 2000 
(otherwise known as an ACPA/2000) offers complete groups 
of 64 ports. 

However, the ACPA board on a 386 Series 1000 (i.e., an 
ACPA/1000) addresses a variable number of ports, depending 
on the number and type of boards preceding it on the ma- 
chine backplane. (Refer to your Release Notes for details 
on these limitations.) 

In general, the ACPA/1000 addresses the remaining ports up 
to port 63 after the preceding boards. For example, in a 
system with an SIO (8 ports), the ACPA/1000 addresses 
ports 08 - 63. If the system has two SIOs (addressing the 
first 16 ports), the ACPA/1000 addresses ports 16 - 63. 

Tables 3-1 and 3-2 on the following page shows some ex- 
amples of board configurations and addresses. 
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Table 3-1. Sample COMM Board Configurations and 
Addresses - 386 Series 2000 



Addresses 

Board Available Address/Type of Port 



EXAMPLE 1: 

MDC (primary board) 00 

MDC (second board) 64 

SIO (third board) 128 

EXAMPLE 2: 

SIO (primary board) 00 

MDC (second board) 10 
EXAMPLE 3: 

AGFA (primary board) 00 

SIO (second board) 64 



63 


00 - 
05 - 


04 
63 


(RS-232) 
(RS-422) 


127 


64 - 
69 - 


68 
127 


(RS-232) 
(RS-422) 


137 


128 - 


137 


(RS-232) 


09 


00 - 


09 


(RS-232) 


73 


10 - 
15 - 


14 
73 


(RS-232) 
(RS-422) 


63 


00 - 
05 - 


04 
63 


(RS-232) 
(RS-422) 


73 


64 - 


73 


(RS-232) 



Table 3-2. Sample COMM Board Configurations and 
Addresses - 386 Series 1000 



Addresses 

Board Available Address/Type of Port 



EXAMPLE 1: 

SIO (primary board) 00 - 07 00 - 07 (RS-232) 
SIO (second board) 08 - 15 08 - 15 (RS-232) 
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Table 3-2. Sam^ COMM Board Configuratloiis and 
Addresses - 386 Series 1000 (Cont.) 



Addresses 

Board AvaOaMe Address/Type of Port 



EXAMPLE 2: 

SIO (primary board) DO 

SIO (second board) 08 

AGFA (third board) 16 



07 


00 


- 07 


(RS-232) 


15 


08 


- 15 


(RS-232) 


63 


16 


- 20 


(RS-232) 




21 


- 63 


(RS-422) 



To see the first and last port number you can use on the 
communications boards loaded on your system, log in as 
root and use the devinfo command as shown below: 

devinfo and press WBIW 

For exanq>le, the screen udgtit display the following infor- 
mation: 



Board t^mmm H^jftf >r*fix 1^it$% ImUX 



Refer to the description of devinfo(C) in the Altos System 
V Series 386 Reference (C) for further information, espe- 
cially regarding the use of devinfo on Altos 386 Series 
1000 systems. 
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SET-UP PROCEDURE SUMMARY 



There are three basic steps to setting up a Multidrop 53^5- 
tem on your Altos computer: 

1. Connect the cables. 

2. Set the TCU-8 switches. 

3. Configure the ports with pconfig. 

Refer to the Multidrop Installation manual (or the "In- 
stalling Multidrop" chapter of your Owner's Guide) and the 
TCU-8 Hardware Setup Guide for details on steps 1 and 2 
above. 

Step 3 (configuring ports) is described in CHiapter 1 of 
this nmnual tmder "Setting Up the Ports for Terminals and 
Printers." You can find similar information in CHiapter 8 
of the Altos System V Series 386 Operations Guide^ "Using 
Peripheral Devices." The pconfig port configuration pro- 
gram is described in Altos System V Series 386 Reference 
(C), 

This procedure is summarized in Figure 3-1 on the follow- 
ing pages. This figure uses as its example the setup for 
an MDC with two TCXJ-8s on an Altos 386 Series 2000. 
(Note that on a 386 Series 1000, the Multidrop cable would 
be connected to an ACPA, not an MDC. Otherwise, the re- 
mainder of the setup procedure remains the same.) 
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3R0TCU4 




Figure 3-1. Setting Up Midtidrop 
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(§) Configure the ports with pconfig 

' 





Hardwart Softwara 
Naiw Nax* 




01 «p 

Figure 3-1. Setting Up Multidrop (Cont.) 



3-9 



Setting Up Your Multidrop System 



(BLANK) 



3-10 



. Chapter 4 

/ Uninterruptible Power 
Supply (UPS) 



4-3 INTRODUCTION 

4-3 SmJTKILL 

4-5 SHUTSAVE 

4-8 INSTALLATION CONSIDERATIONS 



4-1 



Uninterruptible Power Supply (UPS) 



(BLANK) 



4-2 



INTRODUCTION 



Uninterruptible Power Supply (UPS) 



This chapter describes the software that supports an Unin- 
terruptible Power Supply (UPS), a device that safeguards 
your computer against data loss when there is a power 
failure. 

Some computers do not support the use of a UPS. If yours 
does, the information on installing and setting up the UPS 
will be in your computer's Owner's Guide. 

If no UPS is installed and a power failure occurs, residual 
power in the system allows active data transfers to com- 
plete before the system halts. 

If a UPS is present on your system and a power failure 
occurs, the system can either: 

• Execute a SHUTKILL, which causes a standard operat- 
ing system shutdown, killing all processes in a con- 
trolled fashion, sending a sync(C) command to ensure 
file system integrity, and halting the system. 
SHUTKILL is the default. 

• Execute a SHUTSAVE, which saves all active pro- 
cesses, which then resume as if there had been no 
interruption when power is restored. 

See "Installation Considerations" later in this chapter to 
determine the type of power-down procedure you want. 



SHUTKILL 



If you have a UPS, your system is initially set to execute 
a SHUTKILL when there is a power interruption. The se- 
quence of events when SHUTKILL is set and a power fail- 
ure occurs is shown in Figure 4-1. 
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POWER INTERRUPTION 





failtime 


"SIGPWR SHUTKILL" 
signal Mnt to ail prooaaai. 




pwrtime 


SIGTERM 

Mnt to all prnraiaii, 




termtime 


SIGKILL 

Mnt to all prnraaiai. 






tyne 






Systam id las and attampts 
to turn off battarias. 



^ i 

reboot^ 

01B76 

Figure 4-1. SHUTKILL Powerdown 
1 

If power i« restored before "failtime" expires, the power failure 
is ignored. 

2 

If the power fails more than "pwrcnt" tines (see shutype(H)), 
SHUTKILL occurs even if the power cones back on. 

3 

If power is restored after "failtine* expires, a reboot is 
guaranteed. 
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SHUTKILL sends a series of signals: SIGPWR, with 
SHUTKILL parameters, SIGTERM, and SIGKILL at intervals 
to all processes running at the time of the power interrup- 
tion. (The SIGPWR signal is ignored if not caught by a 
process.) The time intervals between signals (failtime, 
pwrtime, and termtime) are set with the shutype(M) com- 
mand. The SHUTKILL procedure halts all processes in an 
orderly fashion, flushes I/O buffers to disk (with a sync(C) 
command), idles the S3^tem, and attempts to turn off the 
battery. 



NOTE 

Only an Altos UPS can have its batteries 
turned off at shutdown. 



When power is restored, the state of processes running 
before the power interruption occurred is not preserved. 



SHUTSAVE 



By setting your system to SHUTSAVE instead of SHUTKILL, 
you can save the execution state of all active processes 
at the time of a power failure. The sequence of events 
when SHUTSAVE is set and a power failure occurs is shown 
in Figure 4-2. 



NOTE 

If your S3^tem is running a heavy load, all 
processes may not finish before shutdown. 
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POWER INTERRUPTICm 



failtime 2, 3 



"SIGPWR S 
tsnt to all pi 


HUTSAVE" 
nraiwi. 




pwrtime 


All prooMHS idM. 

Driver shutdown routiMt maeutid. 

Syttam idM. 






MachiiM Stat* 

«av*d in rettart partition. 




I 


Attampt to turn off battarias. 



01577 

Figure 4-2. SHUTSAVE Powerdown 



If power is restored before "failtirae" expires, the power failure 
is ignored. 

If the power fails more than "pwrcnt" times (see 8hutype(N)), 
SHUTKILL occurs even if the power cones back on. 

If power is restored after "failtime" expires, the SHUTSAVE 
powerdown is executed and the system continues after the bat- 
teries recharge to the state in which they can support another 
powerdown . 
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NOTE 

Only an Altos UPS can have its batteries 
turned off at shutdown. 



When a power interruption occurs, the operating system 
sends a SIGPWR signal (with SHUTSAVE parameters) to all 
processes, waits a specified time interval until all processes 
have received the signal and had time to do any desired 
cleanup, ^hen saves all processes in the restart partition on 
the hard disk. (The SIGPWR signal is ignored if not caught 
by a process.) 

When power is restored, the operating system sends a 
SIGPWR signal (with RESTART parameters) to all processes, 
which resume just as they were at the time of the power 
interruption. The power restoration process is shown in 
Figure 4-3. 



f POWER RESTORED ^ 




Boot from rattart partition. 




* 




Drivar rattart rotitinat axacutad. 








"SIGPWR RESTART" 






«ant to all praca«ac. 








ProtaM axocuting ivttorad. 






OI4t3 



Figure 4-3. SHUTSAVE Power Restoration 
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INSTALLATION CONSIDERATIONS 



If you have a UPS, make sure you follow these steps so 
your system functions the way you want it to during a 
power failure: 

1. During installation (see the installation procedure 
in Chapter 1), make sure you answer y for "yes" 
when asked if you want a restart partition. 

This will set up your system for a shutdown, and 
bring the system to single-user mode when a power 
failure happens. 



NOTE 

If you expect to add more main memory to the 
system in the future, you should create a larg- 
er restart partition at the time of installation. 
You can do this by Euiswering "yes" to the ques- 
tions about the restart partition and nonstandard 
layout. The appropriate amount of disk space 
will then be added to the restart partition. The 
restart partiticm must alwajrs be greater than 
or equ2Ll to the amoimt of main memory for a 
SHUTSAVE/RESTART sequence to be successful. 



2. Decide which type of powerdown you want to occur: 
SHUTKILL or SHUTSAVE. Your system is already set 
to SHUTKILL. To select SHUTSAVE, you can use the 
shutype(M) command or you can edit the /etc/brc file 
directly. 

To select SHUTSAVE with the shutype(M) conmiand, 
enten 

shutype -t^utsave 
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If you use the shutype(M) command to select 
SHUTSAVE, the selection will be in effect until the 
next time the system is brought to Multiuser mode. 
At that time, the system will revert to the default 
SHUTKILL. 

To select SHUTSAVE permanently, edit the /etc/bre 
file by adding the following line: 

shutype -tshutaave 

For information on changing these options, see 
shutype(M) in the Alfos System V Series 386 Refer- 
ence (M). 
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lange Information 



This is a summary of the changes that have been made to 
the previous version of this manual. The chapters, page 
numbers, and/or paragraphs mentioned in this summary ref- 
erence the previous manual. 



Title: Altos System V Series 386 Installation 



Revised Part Numben 690-21170-007 



Previous Part Numben 690-21170-006 

Date: July 1989 

Changes: 

On page 1-10, added description of how to include an 
extra disk partition while installing the operating 
system. 



On page 2-3, made it clear that any communication 
products or applications must be re-installed after 
upgrading the operating system. 

On page 2-4, added the -g option to the /etc/shutdown 
conmiand, which must now precede its argument. 

In Chapter 3, "Setting Up Your Multidrop System," 
broadened the discussion to include AGFA communica- 
tions boards. Also, added information specific to 
386 Series 1000 systems. 

On page 3-5, noted that SIO boards can have eight or 
ten ports, depending on system type. 
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On page 3-6, corrected some minor inaccuracies in 
the table containing COMM board configurations and 
addresses. Also addded some additional examples 
and split it into two spearate tables. 

On pages 4-8 and 4-9, corrected the shutype -t for- 
mat; there should be no space between the -t option 
and the following argument (in this cases, shutsave). 
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